home *** CD-ROM | disk | FTP | other *** search
/ Over 1,000 Windows 95 Programs / Over 1000 Windows 95 Programs (Microforum) (Disc 1).iso / 0939 / os.man < prev    next >
Text File  |  1995-04-29  |  37KB  |  1,026 lines
  1. OnScreen/2 File Viewer,                                    Release 2.11 22/01/95
  2.                                                                     User's Guide
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Warp Factor 7
  61. OnScreen/2 the file browser and viewer
  62. for OS/2, DOS & Win32
  63.  
  64. ------------------------------------------------------------------------------
  65. Warranty
  66.  
  67. The author hereby disclaims all  warranties relating to this software, whether
  68. express or implied, including without limitation  any  implied  warranties  of
  69. merchantibility  or  fitness for a particular purpose.  The author will not be
  70. liable for any special, incidental, consequential, indirect or similar damages
  71. due to loss of data or any other reason, even if the author or an agent of the
  72. author has been advised of the possibility of such damages.  In no event shall
  73. the author's liability ever exceed the  price  paid for the license to use the
  74. software, regardless of the form of the claim.  The person using the  software
  75. bears all risk as to the quality and performance of the software.
  76.  
  77. Support
  78.  
  79. The  only  form of support available for OnScreen/2 at the moment is via email
  80. or surface mail  to  the  author.   You  may  also telephone at 353-1-4937616,
  81. generally between the hours of 6pm-11pm GMT, although I can't guarantee to  be
  82. in.   Telephone support should only be used as a last resort.  I expect to get
  83. a CompuServe account soon and support will also be available there.
  84.  
  85. Email and surface mail information is provided below.
  86.  
  87. Availability
  88.  
  89. OnScreen/2 is normally available from the following sites
  90. hobbes.nmsu.edu:/os2/32bit/editors       OS/2 version
  91. ftp.cdrom.com:/pub/os2/32bit/editors     OS/2 version
  92. garbo.uwasa.fi:/pc/fileutil              DOS version
  93. ftp.cica.indiana.edu:/pub/pc/win3/nt     Win32 version
  94.  
  95. New releases and bug fixes  are  posted  regularly to these sites.  OnScreen/2
  96. may be available from other  locations  but  the  above  will  have  the  most
  97. recently released versions or bug fixes.
  98.  
  99. If  you  are a registered user you will be informed via email of bug fixes and
  100. new releases.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Copyright 1995, by John J. Allen.
  115. All rights reserved.
  116.  
  117. John Allen,
  118. Warp Factor 7,
  119. 121 Moyville,
  120. Rathfarnham,
  121. Dublin 16,
  122. Ireland.
  123.  
  124. Internet:      jallen@iol.ie
  125. CompuServe:
  126.  
  127. ------------------------------------------------------------------------------
  128. OnScreen/2 User's Guide             Page 1-2
  129. Table of Contents
  130.  
  131. 1. GETTING STARTED                                   1-4
  132.  
  133.  1.1. INTRODUCTION                                   1-4
  134.  
  135.  1.2. INSTALLATION                                   1-4
  136.  
  137.  1.3. COMPATIBILITY                                  1-4
  138.  
  139.  1.4. ACKNOWLEDGEMENTS                               1-4
  140.  
  141.  1.5. FEATURE LIST                                   1-5
  142.  
  143.  1.6. FUTURE STUFF                                   1-5
  144.  
  145. 2. USING ONSCREEN                                    2-6
  146.  
  147.  2.1. STARTING ONSCREEN                              2-6
  148.   2.1.1. COMMAND LINE SYNTAX                         2-6
  149.   2.1.2. REDIRECTION/PIPING                          2-6
  150.  
  151.  2.2. EXITING ONSCREEN                               2-7
  152.  
  153.  2.3. FILE VIEWER                                    2-8
  154.   2.3.1. COMMANDS                                    2-8
  155.   2.3.2. TEXT WITH LAYOUT INFORMATION                2-8
  156.   2.3.3. TAB EXPANSION                               2-8
  157.   2.3.4. HEX MODE                                    2-8
  158.   2.3.5. HI-BIT FILTER                               2-9
  159.   2.3.6. BOOKMARKS                                   2-9
  160.   2.3.7. MEMORY USAGE                                2-9
  161.   2.3.8. SEARCHING                                   2-9
  162.   2.3.9. INVOKING A SHELL                            2-10
  163.   2.3.10. VIDEO MODE SUPPORT                         2-10
  164.   2.3.11. INVOKING AN EDITOR                         2-10
  165.   2.3.12. STATUS LINES                               2-11
  166.   2.3.13. COMMAND KEYS                               2-12
  167.  
  168.  2.4. BUFFER LIST                                    2-13
  169.   2.4.1. COMMANDS                                    2-13
  170.   2.4.2. COMMAND KEYS                                2-13
  171.  
  172.  2.5. LINE EDITOR                                    2-13
  173.   2.5.1. COMMAND KEYS                                2-13
  174.  
  175.  2.6. FILE MANAGER                                   2-14
  176.   2.6.1. COMMANDS                                    2-14
  177.   2.6.2. COMMAND KEYS                                2-14
  178.  
  179. 3. CONFIGURATION                                     3-15
  180.  
  181.  3.1. STYLES                                         3-15
  182.  
  183.  3.2. CONFIGURABLE ITEMS                             3-16
  184.  
  185.  3.3. COLOURS                                        3-16
  186.  
  187.  
  188.  
  189.  
  190.  
  191. ------------------------------------------------------------------------------
  192. OnScreen/2 User's Guide             Page 1-3
  193.  1.    Getting Started
  194.  
  195.   1.1. Introduction
  196.   Welcome to  OnScreen/2,  a  sophisticated  fullscreen  text  and binary file
  197.   viewer for the  OS/2,  DOS  and  Win32  operating  systems  running  on  IBM
  198.   compatible PCs based on the 386 or higher CPUs.
  199.  
  200.   OnScreen/2  displays  files  in  a  text  window  or  fullscreen session and
  201.   provides scrolling,  positioning  and  filtering  commands.   The motivation
  202.   behind OnScreen/2 was to provide an identical (or as near  as  possible  to)
  203.   text mode file viewer for OS/2, DOS and Win32.
  204.  
  205.   OnScreen/2  provides  a powerful file browser for selecting files which also
  206.   provides basic file management functionality.
  207.  
  208.   OnScreen/2 supports redirected input (i.e.  piping).
  209.  
  210.   1.2. Installation
  211.   OnScreen/2 installation could not be simpler, just change into the directory
  212.   where you unzipped OnScreen/2 to and run install.
  213.  
  214.   If you executed the command unzip os2_11or.zip  in A:\ then you would have a
  215.   directory named OnScreen/2 in A:\.  Simply change to A:\ and type install.
  216.  
  217.   If you are using PKUNZIP you will have to use the -d  option  otherwise  you
  218.   will not have the required directory structure for the installation program.
  219.  
  220.   When  installing  the  OS/2 or Win32 version you can install either the .DLL
  221.   implementation or the  non  .DLL  implementation.   If  you  do not envisage
  222.   installing any of the other Warp Factor 7 utilities (availability early  95)
  223.   then installing the non .DLL version is most likely what you should do.
  224.  
  225.   The  installation  program  allows you to specify which directory to use for
  226.   the OnScreen/2 base files and the .DLL files.  It also allows you to specify
  227.   whether you want the .DLL version or not.
  228.  
  229.   1.3. Compatibility
  230.   OnScreen/2  2.11  has  been  tested  for  compatibility  with  the following
  231.   operating systems.
  232.  
  233.   OS/2: Versions 2.0, 2.1, 2.11 and 3.0 Warp.
  234.  
  235.   Windows NT: Version 3.5 only.
  236.  
  237.   Windows 95: Final beta only.
  238.  
  239.   DOS: Versions 5.0, 6.0, 6.21, 6.22.
  240.  
  241.   1.4. Acknowledgements
  242.   IBM for producing and supporting  OS/2,  the best operating system for PC's.
  243.   Henk Den Adel for writing the original manual and for his continued  testing
  244.   and  suggestions.  Mitch Williams, Lionel B. Dyck and Norris Counch for Beta
  245.   testing.  Kevin Scally for the fabulous Warp Factor 7 logo.
  246.  
  247.   Borland  International  for  their  C++  compilers,  DOS Extenders and Brief
  248.   editor.
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255. ------------------------------------------------------------------------------
  256. OnScreen/2 User's Guide             Page 1-4
  257.   1.5.  Feature list
  258.          Case-sensitive/insensitive regular expression and
  259.           plain text searches.
  260.          Horizontal scrolling 10 chars at a time.
  261.          Page up & down.
  262.          Go to top or bottom of file.
  263.          Go to a specific line.
  264.          Go to previous or next file.
  265.          Load OS/2, MAC & Unix text files and binary files.
  266.          Supports redirected stdin.
  267.          Command help with ? or F1. (os.hlp must be in same
  268.           dir as os.exe)
  269.          Toggleable sound.
  270.          Toggleable tab expansion.
  271.          User configurable tab size.
  272.          Customisable colours.
  273.          Configuration saving.
  274.          Quick file select using keys 1 to 9.
  275.          32 bit versions for OS/2, DOS and Windows NT.
  276.          Selection list for loaded files.
  277.          Remove file from loaded list.
  278.          Run with no arguments brings up file selection
  279.           browser.
  280.          Run with one argument which is a directory brings up
  281.           file selection browser.
  282.          Line editor with history recall for input on bottom
  283.           status line.
  284.          Bookmarks.
  285.          Multiple top line display formats.
  286.          Hex mode.
  287.          Bright background colours.
  288.          Display of text with layout information.
  289.          User definable styles, including syntax
  290.           highlighting.
  291.          Invoke editor. (Including PM or Win32 apps)
  292.          Display output of filter rather than file contents.
  293.          Enhanced file selection browser with edit, copy,
  294.           rename, delete, move, sort, change directory,  make
  295.           directory and set file matching pattern.
  296.          Search in HEX mode.
  297.          Go to offset in HEX mode.
  298.  
  299.   1.6. Future stuff
  300.          Faster regular expression searching.
  301.          Option to use standard OS/2, DOS or NT wildcards.
  302.          Background file loading.
  303.          File tagging in the file browser.
  304.          Invoke any command on tagged file set.
  305.          User specified key bindings.
  306.          Text with layout recognize ANSI Escape sequences.
  307.          Cross file bookmarks.
  308.          Printing support including Postscript.
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319. ------------------------------------------------------------------------------
  320. OnScreen/2 User's Guide             Page 1-5
  321. 2.    Using OnScreen/2
  322.  
  323.   2.1. Starting OnScreen/2
  324.      2.1.1.    Command line syntax
  325.      You may start OnScreen/2 with  or without parameters.  The general syntax
  326.      is as follows:-
  327.  
  328.      os [switches] [filespec...]
  329.  
  330.      Switches comprise one or more / characters followed by option letters  or
  331.      numbers. (eg. /help)
  332.  
  333.      The following switches are available in this release.
  334.      /help                   displays the list of switches
  335.      /ignorestdin            causes OnScreen/2 to ignore redirected stdin
  336.      /raw style              disables filter for specified style
  337.      /search regexp|plain    set searches to regular expression or plain text
  338.      /textwithlayout on|off  turn textwithlayout on or off
  339.      /highbit on|off         turn highbit filter on or off
  340.  
  341.      A hyphen (-) may be  used  in  place  of  the /. The environment variable
  342.      SWITCHCHAR can be set to the list of characters that will be accepted  as
  343.      switch characters. (eg. SET SWITCHCHAR=/-$)
  344.  
  345.      Filespec may  be  one  or  more  filenames  which  may contain wildcards.
  346.      OnScreen/2 uses a regular expression pattern matcher  for  the  wildcards
  347.      and therefore does not conform to the standard OS/2, DOS or Win32 command
  348.      shell wildcards.
  349.  
  350.      OnScreen/2 wildcards are as follows:-
  351.  
  352.      *      Match zero or more occurrences of any character.
  353.      .      Match the period/fullstop character.
  354.      ?      Match a single occurence of any character.
  355.      [az]   Match a single occurence of specified characters.
  356.      [a-z]  Match a single occurence of specified range of characters.
  357.  
  358.      For  example  the  wildcard  file  specification xxx.[qa]*.xyz will match
  359.      files beginning with xxx.  followed  by  a  q  or  an  a and zero of more
  360.      occurrences of any character followed by .xyz.
  361.  
  362.      If OnScreen/2 is started without any command line parameters  or  with  a
  363.      single  parameter  which  is the name of a directory it will bring up the
  364.      file browser.
  365.  
  366.      2.1.2.    Redirection/piping
  367.      OnScreen/2 is capable of acting as  a command line filter.  An example of
  368.      this is:-
  369.  
  370.      [C:\]dir c:\ /s | os
  371.  
  372.      There  are  some  restrictions in the current release.  With this release
  373.      OnScreen/2 has to read the entire output before it will display anything.
  374.      This means that until  the  command  which  is  generating the output has
  375.      completed you will not be able to view the output with OnScreen/2.   This
  376.      restriction will be lifted in a future release.
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383. ------------------------------------------------------------------------------
  384. OnScreen/2 User's Guide             Page 2-6
  385.  
  386.   2.2. Exiting OnScreen/2
  387.   There are three different ways to exit from OnScreen/2.
  388.  
  389.    The Alt+Q command clears the screen and then returns to the prompt.  The  Q
  390.    and X commands also perform the same function.  The Alt+Q function works in
  391.    both  the file viewer and the file browser.  The Q and X commands only work
  392.    in the file viewer.
  393.  
  394.    The Alt+A command returns  to  the  prompt  clearing  the  last line on the
  395.    screen but otherwise leaving the display exactly as it was.  The Ctrl+X and
  396.    ESC commands also perform the same function  but  only  work  in  the  file
  397.    viewer and the ESC command only quits if there are no files are loaded.
  398.  
  399.    The Alt+X key combination restores the screen to the display you had before
  400.    OnScreen/2  was  run  and then returns to the prompt.  It works in both the
  401.    file viewer and the file browser.
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447. ------------------------------------------------------------------------------
  448. OnScreen/2 User's Guide             Page 2-7
  449.   2.3.  File Viewer
  450.      2.3.1.    Commands
  451.      You control the OnScreen/2 File  Viewer  by pressing keys or combinations
  452.      of keys which correspond to the OnScreen/2 File  Viewer  commands.   Some
  453.      commands  have  more  than one key combination associated with them, e.g.
  454.      Next File = Alt+N or Ctrl+PgDn.
  455.  
  456.      The key combinations associated with specific commands are pre-programmed
  457.      into the OnScreen/2 File Viewer and cannot be changed at this time.  This
  458.      restriction will be lifted in a future release.
  459.  
  460.      2.3.2.    Text with layout information
  461.      OnScreen/2 can display  files  containing  text  with layout information.
  462.      Files with layout information  contain  special  characters  that  direct
  463.      OnScreen/2  to display subsequent characters in a different colour.  This
  464.      User's Guide contains these special  characters.  If you are viewing this
  465.      guide using OnScreen/2 you can press L now to  toggle  text  with  layout
  466.      information off so you can see these characters.
  467.  
  468.      Two methods of controlling the colour of the text are supported.
  469.      UNIX(tm) nroff style and Wordstar(tm) style.
  470.  
  471.      nroff uses the following format:-
  472.  
  473.       _<BKSPACE><CHARACTER>            Display character in underlined colour.
  474.       <CHARACTER><BKSPACE><CHARACTER>  Display character in bold colour.
  475.  
  476.      Wordstar(tm) uses the following format:-
  477.  
  478.       ^B  text ^B                      Display text in bold colour.
  479.       ^S  text ^S                      Display text in underlined colour.
  480.      ^B^S  text ^S^B                   Display text in bold and underlined
  481.                                        colour.
  482.  
  483.      The  text  with  layout  option can be toggled with the L command, it can
  484.      also be set on a per  file-type  basis  by creating a style with the text
  485.      with layout option either ON or OFF in the os.set settings file
  486.  
  487.      2.3.3.    Tab Expansion
  488.      When Tab expansion is enabled OnScreen/2 will display the correct  number
  489.      of  spaces for each Tab character it encounters.  The default Tab size is
  490.      3, but this can be changed with  the Tab and Shift+Tab commands.  The Tab
  491.      size can also be set on a per file-type basis by creating a style with  a
  492.      specific Tab size in the os.set settings file.
  493.  
  494.      2.3.4.    Hex Mode
  495.      Hex  mode  displays  the  file  in a format similar to the debug command.
  496.      When switching between text mode  and  hex  mode an attempt to retain the
  497.      same positioning is made, but this is not always perfect.  Hex  mode  can
  498.      be  toggled  with  the  H  command, it can also be set on a per file-type
  499.      basis by creating a style with  hex  mode  either ON or OFF in the os.set
  500.      settings file.
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511. ------------------------------------------------------------------------------
  512. OnScreen/2 User's Guide             Page 2-8
  513.      2.3.5.    Hi-bit filter
  514.      The high-bit filter strips the high-bit from all characters  above  ASCII
  515.      127.   It  also  handles  the 0x8D character as a carriage-return thereby
  516.      allowing easy viewing of Wordstar(tm)  files.  The high-bit filter can be
  517.      toggled with the .  command.  It can also be set on a per file-type basis
  518.      by creating a style with the high-bit filter either  ON  or  OFF  in  the
  519.      os.set settings file.
  520.  
  521.      2.3.6.    Bookmarks
  522.      You  can  set  a  bookmark  with  the Alt+0..9 commands.  You can go to a
  523.      previously set bookmark  with  the  Alt+G  command  followed by the digit
  524.      representing the bookmark you wish to jump to.
  525.  
  526.      If you drop a bookmark that you had already set elsewhere then it will be
  527.      reset to the new location.  If you wish to clear a bookmark simply go  to
  528.      it and then set it again, this will clear it.
  529.  
  530.      2.3.7.    Memory usage
  531.      OnScreen/2  normally  only  keeps one file loaded at a time (ie.  the one
  532.      you're looking  at),  this  helps  reduce  memory  usage.   The K command
  533.      toggles between keeping all the files you have looked at loaded and  just
  534.      loading the one you are currently viewing.
  535.  
  536.      Obviously  keeping  all files loaded speeds up switching between multiple
  537.      loaded files but it also uses  lots  more memory.  The default is to only
  538.      keep the currently viewed file loaded.
  539.  
  540.      2.3.8.    Searching
  541.      OnScreen/2  provides  for  searches  which  can  be  case-sensitive   and
  542.      case-insensitive  and may be either forwards or backwards as you require.
  543.      OnScreen/2  also  provides  for  regular  expression  searches.   Regular
  544.      expressions are a powerful way of expressing a pattern that a search will
  545.      match.
  546.  
  547.      With regular expressions you can specify searches such as the following:-
  548.  
  549.      d[ie]*lay
  550.  
  551.      This will find text where it begins with a d followed by an i or an e and
  552.      zero or more occurrences  of  any  character  followed by lay.  This will
  553.      find words such as delay and display.
  554.  
  555.      Unlike  typical  UNIX based applications OnScreen/2's regular expressions
  556.      are capable of being case-sensitive or case-insensitive.
  557.  
  558.      For a case-sensitive search use the S,  Alt+S  or  /  commands,  and  for
  559.      case-insensitive  searches use the F, Alt+F or \ commands.  The Alt+F and
  560.      Alt+S commands search backwards.
  561.  
  562.      OnScreen/2 starts searches either from  the line the current selection is
  563.      on, or from the top of the file if there is no selection active.  You can
  564.      clear the current selection with the C command.
  565.  
  566.      The A and Ctrl+L commands repeat the previous search.  All the parameters
  567.      of the previous search are preserved with the exception of the setting of
  568.      the regular expression toggle, which can be toggled on  and  off  between
  569.      repeat searches.
  570.  
  571.      OnScreen/2  will  scroll the display up, down, left or right as necessary
  572.      to bring the matching text  into  view.   Only  the matching text will be
  573.      highlighted not the entire line.
  574.  
  575. ------------------------------------------------------------------------------
  576. OnScreen/2 User's Guide             Page 2-9
  577.      2.3.9.      Invoking a shell
  578.      You can invoke a shell by using the Alt+O command.  This will take you to
  579.      the current default shell for the operating system for  which  OnScreen/2
  580.      has  been  compiled.   You  may execute any command you normally would at
  581.      this shell with the  exception  of  TSR's.   You  may  find that in a DOS
  582.      environment you have too little memory to do any serious work within this
  583.      shell.
  584.  
  585.      Use the EXIT command to return to OnScreen/2.
  586.  
  587.      NB: TSR's do not affect the OS/2 or Win32 environments.
  588.  
  589.      2.3.10.   Video mode support
  590.      OnScreen/2 supports whatever text mode you happend to be in.  It does not
  591.      have any built in facility to change text mode.  You can change  it  with
  592.      the  mode  command  or  a  utility which may have been supplied with your
  593.      video card.
  594.  
  595.      Windows NT allows  you  to  change  the  number  of  rows  and columns of
  596.      windowed sessions.  It is not recommended that you change these  settings
  597.      while  you  are  running OnScreen/2.  It is also not recommended that you
  598.      switch to  fullscreen  if  you  are  using  settings  that  would  not be
  599.      supported there.
  600.  
  601.      OnScreen/2 cannot operate in less than 80 column mode.
  602.  
  603.      2.3.11.     Invoking an editor
  604.      The Alt+E command invokes an editor on the current file.  The editor must
  605.      be set in the os.set file.  A default editor can be assigned by  defining
  606.      a  style from which all others inherit.  SubStyles can prevent editing by
  607.      setting the editor to blank.
  608.  
  609.      eg. Editor =>
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639. ------------------------------------------------------------------------------
  640. OnScreen/2 User's Guide             Page 2-10
  641.      2.3.12.     Status Lines
  642.      The top and bottom lines of  the  display are status lines.  The top line
  643.      provides status information relating to the file currently being viewed.
  644.  
  645.      The bottom status line displays the name  of  the  program,  the  release
  646.      version  and  the operating system it was compiled for.  It also displays
  647.      the copyright message and  any  error  messages  as  well as serving as a
  648.      location for menu type selection and line editing.  On the far  right  it
  649.      shows  the  current  time in 12 hour format.  The environment variable TZ
  650.      must be set for the time to be displayed correctly.  (eg.  SET TZ=GMT)
  651.  
  652.      There are 3 distinct formats for the top status line.  They can be cycled
  653.      through with the Alt+Z command.
  654.  
  655. Format 1.
  656. --------------------------------------------------------------------------------
  657.         47 |       1024 | +  10 | 12-12-1994 | 12:34pm |*c:\readme
  658. --------------------------------------------------------------------------------
  659.       1            2        3          4          5     6     7
  660.  
  661.      1.   Line number at top of display
  662.      2.   Total number of lines in file
  663.      3.   The current left column offset
  664.      4.   The date the file was last modified
  665.      5.   The time the file was last modified
  666.      6.   An asterisk indicates that the file has been modified
  667.      7.   The path and name of the displayed file
  668.  
  669. Format 2.
  670. --------------------------------------------------------------------------------
  671.         47 |        15% | +  10 | 12-12-1994 | 12:34pm |*c:\readme
  672. --------------------------------------------------------------------------------
  673.       1            2        3          4          5     6     7
  674.  
  675.      1.   Line number at top of display
  676.      2.   Percentage from the beginning of the file
  677.      3.   The current left column offset
  678.      4.   The date the file was last modified
  679.      5.   The time the file was last modified
  680.      6.   An asterisk indicates that the file has been modified
  681.      7.   The path and name of the displayed file
  682.  
  683. Format 3.
  684. --------------------------------------------------------------------------------
  685. 02-04-1994 | 12:34pm |     48290 |        134 |*c:\readme
  686. --------------------------------------------------------------------------------
  687.      1          2          3          4        5     6
  688.  
  689.      1.   The date the file was last modified
  690.      2.   The time the file was last modified
  691.      3.   Total number of lines in file
  692.      4.   Line number at top of display
  693.      5.   An asterisk indicates that the file has been modified
  694.      6.   The path and name of the displayed file
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703. ------------------------------------------------------------------------------
  704. OnScreen/2 User's Guide             Page 2-11
  705.      2.3.13.     Command Keys
  706.      Key                 Function
  707.      .                   Toggle highbit filter on/off
  708.      -, Ctrl+-           Dump current file
  709.      *                   Refresh file
  710.      1..9                Quick select files 1 to 9
  711.      A, Ctrl+L           Search again. Preserves parameters of previous search
  712.      B                   Bring up buffer list
  713.      C                   Clear current selection
  714.      D                   Toggle external filter on/off
  715.      F, \                Case insensitive search forwards
  716.      G                   Go to line number
  717.      H                   Toggle hex display mode on/off
  718.      K                   Toggle keep files loaded on/off
  719.      L                   Toggle text with layout on/off
  720.      O                   Toggles warning beeps on/off
  721.      R                   Toggle regular expressions on/off for searches.
  722.      S, /                Case sensitive search forwards
  723.      W                   Toggle word break
  724.      X, Q, Alt+Q         Quit clearing screen
  725.      Left Arrow          Scroll right ten characters
  726.      Right Arrow         Scroll left ten characters
  727.      Up Arrow            Scroll the file down on line
  728.      Down Arrow          Scroll the file up one line
  729.      Ctrl+Left Arrow     Scroll the file left to column 0
  730.      PageUp              Scroll up one page
  731.      PageDown, Enter     Scroll down one page
  732.      Space               Scroll down one page
  733.      Home                Go to the top of the file
  734.      End                 Go to the bottom of the file
  735.      Alt+A, ESC, Ctrl+X  Quit leaving display as is
  736.      Alt+0..9            Drop a bookmark
  737.      Alt+E               Invoke editor
  738.      Alt+F               Case insensitive search backwards
  739.      Alt+G               Go to book mark
  740.      Alt+O               Go to shell
  741.      Alt+S               Case sensitive search backwards
  742.      Alt+V, +            Bring up file browser
  743.      Alt+X               Quit restoring screen
  744.      Alt+Z               Change top line display format
  745.      Ctrl+PageUp, Alt+P  Previous File
  746.      Ctrl+PageDown,      Next File
  747.      Alt+N               Next File
  748.      F1                  View users guide (os.man)
  749.      Shift+F1            View users guide (os.inf, OS/2 only)
  750.      ?                   Display keys help
  751.      F2                  Change foreground text colour
  752.      Shift+F2            Change background text colour
  753.      F3                  Change foreground selected text colour
  754.      Shift+F3            Change background selected text colour
  755.      F4                  Change foreground status line text colour
  756.      Shift+F4            Change background status line text colour
  757.      F5                  Change the BOLD text colour
  758.      F6                  Change the UNDERLINED text colour
  759.      F7                  Change the BOLD+UNDERLINED text colour
  760.      Tab                 Increase the Tab width
  761.      Shift+Tab           Decrease the Tab width
  762.      Ctrl+Tab            Toggle Tab expansion on/off
  763.      Ctrl+F              Display full file name on status line
  764.      Ctrl+S              Save current settings
  765.  
  766.  
  767. ------------------------------------------------------------------------------
  768. OnScreen/2 User's Guide             Page 2-12
  769.   2.4.  Buffer list
  770.      2.4.1.    Commands
  771.      You control the OnScreen/2 Buffer  List  by pressing keys or combinations
  772.      of keys which correspond to the OnScreen/2 Buffer List commands.
  773.  
  774.      The key combinations associated with specific commands are pre-programmed
  775.      into the OnScreen/2 Buffer List and cannot be changed at this time.
  776.  
  777.      2.4.2.    Command Keys
  778.      Key                 Function
  779.      Up Arrow            Move up one file
  780.      Down Arrow          Move down one file
  781.      Enter               Select current file
  782.      Escape              Return back to previously viewed file
  783.  
  784.   2.5. Line Editor
  785.      2.5.1.    Command Keys
  786.      Key                 Function
  787.      Up Arrow            Select previous item from the history.
  788.      Down Arrow          Select next item from the history.
  789.      Left Arrow          Move one character to the left
  790.      Right Arrow         Move one character to the right
  791.      Home                Move to beginning of line
  792.      End                 Move to end of line
  793.      Backspace           Delete character preceding cursor
  794.      Del                 Delete character under cursor
  795.      Enter               Finished editing
  796.      Escape              Cancel operation
  797.  
  798.      The line editor provides for history recall of previously  entered  text.
  799.      This  feature  is  not  always  enabled,  but  when  it is you can recall
  800.      previously entered text by pressing the up arrow key.
  801.  
  802.      After moving up in the history you  can move back down again by using the
  803.      down arrow key.  The number of  elements  a  history  can  hold  is  only
  804.      limited by available memory.
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831. ------------------------------------------------------------------------------
  832. OnScreen/2 User's Guide             Page 2-13
  833.   2.6.  File Manager
  834.      2.6.1.    Commands
  835.      You  control the OnScreen/2 File Manager by pressing keys or combinations
  836.      of keys which correspond to the OnScreen/2 File Manager commands.
  837.  
  838.      The key combinations associated with specific commands are pre-programmed
  839.      into the OnScreen/2 File Manager and cannot be changed at this time.
  840.  
  841.      2.6.2.    Command Keys
  842.      Key                 Function
  843.      Up Arrow            Move up one file
  844.      Down Arrow          Move down one file
  845.      Left Arrow          Move one column to the left
  846.      Right Arrow         Move one column to the right
  847.      Home                Move to top left. If already at top left then move
  848.                          to first file
  849.      End                 Move to bottom right. If already at bottom right then
  850.                          move to last file
  851.      Tab                 Move to next matching file
  852.      Backspace           Move to previously matching file
  853.      Enter               Select current file
  854.      Escape              Return to previously viewed file or quit
  855.      Ctrl+A..Z           Change current disk
  856.      /                   Bring up file browser menu
  857.      Alt+A               Quit leaving the screen as it is
  858.      Alt+C               Copy the currently selected file
  859.      Alt+D               Delete the currently selected file
  860.      Alt+E               Edit the currently selected file
  861.      Alt+F               Change filespec filter
  862.      Alt+H               Change directory
  863.      Alt+K               Make directory
  864.      Alt+M               Move the currently selected file
  865.      Alt+Q               Quit clearing the screen
  866.      Alt+R               Rename the currently selected file
  867.      Alt+S               Sort directory listing
  868.      Alt+V               View the currently selected file
  869.      Alt+X               Quit restoring the screen
  870.      Space               Toggle the file tag. (not yet available)
  871.  
  872.  
  873.      The file browser  provides  for  quick  file  and  directory selection by
  874.      allowing you to type in a prefix for the file you are trying to select.
  875.  
  876.      For example if you are trying to select the file  custinv.cpp  you  could
  877.      type cus and this will move the file selection bar to the first file with
  878.      the prefix cus.
  879.  
  880.      The  Tab and Backspace keys move you forwards and backwards respectively.
  881.      If you hold down the shift key  then  you are in directory select mode as
  882.      opposed to file select mode.
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895. ------------------------------------------------------------------------------
  896. OnScreen/2 User's Guide             Page 2-14
  897. 3.    Configuration
  898. OnScreen/2's configuration can be controlled from the  keyboard  or  from  the
  899. os.set  file.   The  preferred method is to use the os.set file as this is the
  900. way all OnScreen/2 settings will be stored in the future.
  901.  
  902. If you are viewing  a  file  for  which  a  style  applies and make changes to
  903. OnScreen/2 settings using the command keys, you are only affecting that style.
  904. The bottom status line will indicate that a change has been made to a style as
  905. against a global change.
  906.  
  907. Changes made to a style using the  command  keys  are  not  permanent.   These
  908. changes  are lost once the OnScreen/2 session is terminated.  You will have to
  909. edit the os.set file to affect those changes permanently.
  910.  
  911. Future releases of OnScreen/2 will  store  global or style specific changes to
  912. the os.set file and the os.ini file will be removed.
  913.  
  914.  
  915.   3.1. Styles
  916.   The  os.set  file  allows  for  the specification of one or more user defined
  917.   styles which can be associated with  specific file extensions.  Comments in a
  918.   set file begin with a ; and end at eol.
  919.  
  920.   Style name (extensions list) [inherited styles]
  921.   {
  922.   BackGndColor        => Green
  923.   }
  924.  
  925.   eg.
  926.   Style C++ (.cpp .cxx .hxx .hpp) Default, C
  927.   {
  928.   Reserved       => private
  929.                  => catch
  930.   SingleLineComment   => //
  931.   }
  932.  
  933.   This declares a style called C++ which is associated  with  files  with  the
  934.   extensions .cpp .cxx .hxx .hpp and inherits from the styles Default and C. A
  935.   style does not have to inherit from other styles.
  936.  
  937.   The  extensions  list can also be a single *, which indicates that this is a
  938.   default style which will apply to  all  files which have either no extension
  939.   or an extension for which a specific style has not  been  defined.   If  you
  940.   specify this default style it should appear as the first style in the os.set
  941.   file.
  942.  
  943.   See the supplied os.set file for complete examples.
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959. ------------------------------------------------------------------------------
  960. OnScreen/2 User's Guide             Page 3-15
  961.   3.2.  Configurable items
  962.    BackGndColor          The background colour of the default text
  963.    BoldColor             The foreground colour of bold text
  964.    BoldUnderlineColor    The foreground colour of bold+underlined text
  965.    CaseConvert           Convert keywords to the case used in os.set file
  966.    CaseSensitive         Specify language case sensitivity
  967.    CloseComment          The ending for a multiline comment
  968.    ClosePreprocessor     The ending for a preprocessor command
  969.    CommentColor          The foreground colour of comment text
  970.    CommentColumn         The starting column for single line comments (0=none)
  971.    DisplayMode           The display mode, either TEXT or HEX
  972.    Editor                The editor for this file type. (eg. b2.exe)
  973.    Escape                The character which precedes a string delimiter
  974.                          within a string
  975.    ExpandTabs            Expand tabs, either ON or OFF
  976.    ExternalFilter        View the contents of the file through this filter.
  977.    ForeGndColor          The foreground colour of the default text
  978.    HighBitFilter         Highbit filter, either ON or OFF
  979.    IdentColor            The foreground colour of identifiers
  980.    LineContinuation      The line continuation character for the preprocessor
  981.    NumberColor           The foreground colour of numbers
  982.    NumberPrefix          Prefixes which begin a valid number
  983.    OpenComment           The beginning of a multiline comment
  984.    OpenPreprocessor      The beginning of a preprocessor statement
  985.    PreprocessorColor     The foreground colour of preprocessor statements
  986.    Reserved              A reserved keyword
  987.    ReservedColor         The foreground colour of reserved keywords
  988.    SelectedBackGndColor  The background colour of select text
  989.    SelectedForeGndColor  The foreground colour of selected text
  990.    SingleLineComment     The beginning of a single line comment
  991.    Symbols               Characters which are to recognized as symbols
  992.    SymbolsColor          The foreground colour of symbols
  993.    Strings               The characters which enclose strings
  994.    StringColor           The foreground colour of strings
  995.    TabWidth              The width of a tab
  996.    TextWithLayout        Text with layout, either ON or OFF
  997.    TopLineFormat         The format to use for the top status line, 1 2 or 3
  998.    UnderlineColor        The foreground colour of underlined text
  999.  
  1000.  
  1001.   3.3. Colours
  1002.   Black,   Blue,  Green,  Cyan,  Red,  Magenta,  Brown,  LightGray,  DarkGray,
  1003.   LightBlue, LightGreen, LightCyan, LightRed, LightMagenta, Yellow and White.
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023. ------------------------------------------------------------------------------
  1024. OnScreen/2 User's Guide             Page 3-16
  1025.  
  1026.